home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / MUSIC / 525 / README < prev   
Encoding:
Text File  |  1996-04-03  |  12.2 KB  |  346 lines
  1.  
  2. FIVE TO FIVE Version 2.13
  3. -------------------------
  4. for ATARI ST/TT/Falcon
  5.  
  6. by Harald Schönfeld and Bernd Spellenberg
  7.  
  8. Octoeber 1995
  9.  
  10.  
  11. 'Five to Five' is a program to convert various sound file types, as used on
  12. different computer systems. Some packing algorithms and the following file
  13. types are currently supported by 525:
  14.  
  15. - DVSM (ATARI Falcon 'WinRec')
  16. - AVR (ATARI)
  17. - HSN (ATARI 'CrazySounds')
  18. - FORTUNE (ATARI Falcon 'Fortune')
  19. - SD I (ATARI 'Sound Designer')
  20. - SND, AU (Sun, Mac, NeXT)
  21. - WAV (PC)
  22. - AIFF (Mac, ATARI (Cubase))
  23. - Raw data
  24.  
  25. Additionally it is now possible to convert the sample frequency of the sound
  26. data and to use an adjustable low pas filter.
  27.  
  28.  
  29.  
  30. Copyright
  31.  
  32. Copyright 1994-95 by Harald Schönfeld and Bernd Spellenberg.
  33.  
  34. The program 525 is shareware. 525 may and shall be copied and spread under
  35. the condition that all program- and text- files of this archive are
  36. included. Commercial use (distribution, selling the program for money,
  37. spreading via PD disk series or CDs) is not allowed. But the authors may
  38. grant the permission for such use.
  39.  
  40.  
  41. Registration
  42.  
  43. If you use 525 regularely you have to pay the shareware fee of DM 20 ($ 15,
  44. £ 10). Payment can be done via EuroCheque (or other international money
  45. orders if you pay the fee!) or remittance order.
  46.  
  47. Banking account (for remittance orders only):
  48.     Harald Schönfeld
  49.     Kto. 5117726, Vereinigte Sparkasse im Landkreis Fürth, BLZ 76250110
  50. or
  51.     Bernd Spellenberg
  52.     Kto. 122343, Raiffeisenbank Fürth eG, BLZ 76260451
  53.  
  54. Please write your name in the comment field of the remittance order and send
  55. us your name, address, email address and a remark to 525 V2.02 for ATARI
  56. seperately (via mail or email). You will then recieve a personal key from
  57. us that allows you to register yourself in all future versions of the
  58. program for all supported platforms.
  59.  
  60.  
  61. Contact address
  62.  
  63. Send suggestions, criticism, comments, bug reports, cheques and
  64. registrations to:
  65.  
  66. Harald Schönfeld
  67.     Email: Harald.Schoenfeld@rzmail.uni-erlangen.de
  68.     Post: Lerchenstra₧e 2, 90587 Veitsbronn, Germany
  69.  
  70. Bernd Spellenberg
  71.     Email: Bernd.Spellenberg@rzmail.uni-erlangen.de
  72.     Post: Fürther Stra₧e 11, 90617 Puschendorf, Germany
  73.  
  74.  
  75. Beta testers
  76.  
  77. Thanks to  Peter Sergedahl, Thomas 'Gryf' Binder, Wolfgang Simon und Adam
  78. 'Riker' Kulinski (ATARI) and 'Soundy' (OS2).
  79.  
  80.  
  81. Exemption from liability
  82.  
  83. The programmers can not be held responsible for any errors which may occur
  84. while using this software. We do not claim this software is useful for all
  85. applications.
  86.  
  87.  
  88.  
  89. 1. System requirements
  90.  
  91. Five to Five runs on all ATARI computers of the 680x0 series, no matter if
  92. MultiTOS or Magic is installed or not, and on Macintosh computers running
  93. MagicMac. 525 needs about 250 KB free RAM.
  94.  
  95.  
  96.  
  97. 2. Installation
  98.  
  99. Copy the program (525G.PRG=german, 525E.PRG=english) onto your
  100. harddisk.
  101.  
  102. If you own a resource editor, you can insert one of the included 525 icons
  103. into the deskicon.rsc file. In the next step, you can install that icon as
  104. the Five to Five desktop icon.
  105.  
  106.  
  107.  
  108. 3. Usage
  109.  
  110. After starting the program, the 'Convert Sample' dialog is shown and the
  111. 525 menu appears. There are the following menu items:
  112.  
  113.  
  114. Desk/about Five to Five...
  115.  
  116. Informs about the current version number and the regsistered user. To
  117. register as a user, press the 'Register' button and follow the instructions.
  118. After successfull registration the annoying copyright messages will no
  119. longer appear.
  120.  
  121.  
  122. File/Convert...
  123.  
  124. Here you can select samples for conversion and choose a new file type and
  125. format.
  126.  
  127. "File name" is a PopUp to select the import file. Just click onto the PopUp
  128. and select the file in the subsequent file select box. The file will be
  129. opened and 525 tries to get all necessary information from the file header.
  130. A brief information about the file will be shown on the right of the PopUp.
  131.  
  132. If 525 couldn't find a file header, a dialog box appears, where the format
  133. of the sample data has to be defined manually:
  134. - the frequency: Click onto the PopUp to select a predefined frequeny, or
  135.   type in any other frequency.
  136. - the pack/data format
  137. - the number format: Signed or unsigned
  138. - the length of a possible header (to avoid distorsions at the beginning)
  139.  
  140. Many old ST samples are 8 Bit Mono unsigned.
  141.  
  142. To start the program, you can also drag a sound file icon onto the 525
  143. program icon. The file will then be used as import file. Using MultiTOS it
  144. is also possible, to drag a sound file icon from the desktop onto the 525
  145. main dialog window to import the file.
  146.  
  147. "Analyse" will show a detailed information about the import file. If the
  148. file was not yet analysed, the whole file will be scanned now. Then the
  149. information about length, type, format and peak level will be shown. The
  150. reported length is the length of the sample data (without any header). 525
  151. tries to figure out the format by analysing the file header or it simply
  152. uses the definitions you made in the raw file import dialog.
  153.  
  154. To select the export file type, click onto the "File Type" PopUp menu. 525
  155. currently supports 7 different file types:
  156. - DVSM: For WinRec, Win Cut, Fortune (ATARI)
  157. - CIT : For Fortune (ATARI)
  158. - AVR : Many ATARI St/Falcon programs
  159. - HSN : CrazySounds (ATARI)
  160. - SND : Sun, NeXT, Mac
  161. - WAV : PC
  162. - AIFF: Mac, ATARI - also uncompressed AIFC
  163. - AIFF-Cubase: 512 byte aligned, but according to AIFF specifications
  164. - Raw data: Raw data for many different programs
  165.  
  166. To select the format of the export file, click onto the "Format" PopUp. For
  167. every file type the possible file formats will appear in the menu. An actual
  168. format consists of several basic formats:
  169.  
  170. - Stereo / Mono: Two or one channels
  171. - Signed / Unsigned: With or without sign
  172. - Motorola / Intel: For Motorola or Intel CPUs
  173. - 16 / 8 Bit / Mu-Law / Deltapack: 16 or 8 Bit are uncompressed,
  174.   Mu-Law and Deltapack are compressed. Deltapack needs as much memory as
  175.   Mu-Law, but sounds much better. 
  176.  
  177. If you select a format, an abbreviation of the complete format text will
  178. appear in the PopUp.
  179. Selecting 'Keep' in the PopUp menu ensures that the input format is used as
  180. export format if this is possible (which depends on the different file
  181. types). If it is not possible 525 chooses a format that does not use more
  182. memory than the import format.
  183.  
  184. Please notice that it is almost useless to convert a worse format to a
  185. better one. It only requires more memory but sounds the same. But it is
  186. possible that other programms support only some formats.
  187. Converting Mu-Law to deltapack can result in a slightly worse sound quality,
  188. although deltapack is the better format.
  189.  
  190. If the peak level of the import sample is rather low, it is useful to use
  191. "Maximize volume". Using this option, the file will be written with maximal
  192. possible volume (and a peek level of about 99% to 100%). In this case the
  193. file will be scanned once completely. If the following option is active,
  194. too, the file will be even scanned twice.
  195.  
  196. "Fade In/Out" allows you to fade in and out the volume of the sample at the
  197. beginning and end. This is very useful, as there are often some distortions
  198. at this part of the sample. The duration of this effect can be typed in both
  199. for the start and the end of the sample if the option is selected. You can
  200. type in 1 to 9999 milli seconds. If 0 is used, the option has no effect.
  201.  
  202. By selecting the button "Convert Frequency" it is possible to convert the
  203. sample data from the given sample frequency to any other frequency. You can
  204. select this frequency by choosing any from a PopUp with pre defined standard
  205. values or by typing it in.
  206. Converting a sample to a higher frequency increases the length of the file
  207. while the sound quality surely will not get better. Converting to a lower
  208. frequency leads to a shorter file, while the higher frequencies in the
  209. sample data are lost.
  210.  
  211. If frequency conversion is selected, the low pass filter is automatically
  212. activated. This is necessary to avoid harmonic distorsions when converting
  213. to a higer sample rate and to avoid aliasing when converting to a lower
  214. sample rate. The correct edge frequency is automatically selected.
  215. Unfortunately the filtering process takes some additional time. So if you
  216. want to hear the result faster and if you don't care about some distorsions,
  217. you can disable the filter manually.
  218.  
  219. "Low pass filter" can also be selected independently of the frequency
  220. conversion, for example to filter out noise. Just type in the edge frequency
  221. you want. Mark: The highst possible frequency in a sample with the sample
  222. rate f (e.g. 8000Hz) is f/2 (4000Hz). So the highst possible edge frequency
  223. is the half of the sample rate.
  224.  
  225. To write the new file select the "Export" button. At first a file select box
  226. appears to select the export file name. If a file with the same name already
  227. exists, a warning message appears and you can stop the export. During export
  228. a visual progress indicator tells you about the current status of the export
  229. operation. If the export file name is the same as the import file name, a
  230. temporal file will be created. To abort the convert process, press ESC or
  231. UNDO.
  232.  
  233.  
  234. File/Quit
  235.  
  236. Quits the program.
  237.  
  238.  
  239.  
  240. 4. Internals
  241.  
  242. One supported sample type is the DVSM-Format of the programs WinRec, WinCut
  243. and Fortune. Those are programs for the ATARI FALCON.
  244.  
  245. A DVSM sample file has the following structure:
  246.  
  247. typedef struct
  248. {
  249.     char magic[6];     /* "DVSM" */
  250.     int headlen;       /* Headlen in Bytes*/
  251.     int freq;           /* Sample freqency 0=8kHz 7=50kHz*/
  252.     char pack;           /* 0 unpacked, 2=DVS pack method*/
  253.     char mode;         /* 0=Stereo 8Bit,1=Stereo 16Bit,2=Mono 8Bit,3=Mono 16*/
  254.     long blocklen;     /* if pack>0: Length of a packed block*/ 
  255. } DVSMHEAD;
  256.  
  257. followed by cookies and the sound data.
  258.  
  259. The sample frequencies 0 to 7 correspond to the following frequencies:
  260. sam_freq[8]={8195,9834,12292,16390,19668,24585,32778,49170};
  261.  
  262. For further information refer to the WinRec documentation or take a look at
  263. the article series 'Sound Sample Formate' in the german magazin ST Computer
  264. (3/94 - 6/94).
  265.  
  266.  
  267.  
  268. 5. Known Bugs
  269.  
  270. Problems in 256 colours together with NVDI (it's probably NVDI's fault).
  271.  
  272.  
  273.  
  274. 6. Release History
  275.  
  276. 04/12/93: Version 0.9
  277.  
  278. 04/12/94: Version 0.91
  279.           - Correction in DVSM import
  280.  
  281. 05/05/94: Version 1.0
  282.           - AES 4.02 3D support
  283.           - Copyright Maxon
  284.  
  285. 11/27/94: Version 2.0
  286.           - Complete re write of the program.
  287.           - New file types: CIT (Fortune)
  288.                             HSN (CrazySounds)
  289.           - Fade in/out time seperately adjustable
  290.           - Correct volume maximation in connection with fading
  291.           - Visual progress indicator
  292.           - Drag&Drop
  293.  
  294. 02/01/95: Version 2.01
  295.           - New file type: AIFF (Mac, ATARI)
  296.                            AIFF-Cubase (Cubase)
  297.           - Iconize bug with MultiTOS in monochrome mode fixed
  298.           - Bug in user defined message handling corrected
  299.  
  300. 03/05/95: Version 2.01 for OS/2
  301.  
  302. 03/12/95: Version 2.02 for ATARI
  303.           - Shareware registration dialog
  304.           - Icon for desktop resource file included
  305.  
  306. 04/17/95: Version 2.1 for ATARI
  307.           - Frequency conversion
  308.           - Adjustable low pass filter
  309.           - User break during conversion by pressing ESC or UNDO
  310.           - The program can now be hidden using MagiC
  311.           - Bug in command line parameter handling corrected
  312.           - Correct file delete of the export file during 'disk full' on MTOS/MagiC
  313.  
  314. 07/18/95: Version 2.11 for ATARI
  315.           - Check back if export file already exists
  316.           - Bugfix in dialog memory management
  317.           - Problem with export status bar fixed
  318.           - Bug in registration dialog fixed
  319.           - Bug in DVS-Import/Export with frequency conversion fixed
  320.  
  321. 07/18/95: Version 2.11 for OS/2
  322.           - Functionally equivalent to the ATARI version 2.11
  323.           - First German release
  324.  
  325. 09/03/95: Version 2.12 for ATARI
  326.           - Header skip function for raw files
  327.           - No crashing on import files without extension
  328.           - No sreen redraw when iconyfied anymore
  329.  
  330. 09/10/95: Version 2.12 for OS/2
  331.           - Functionally equivalent to the ATARI version 2.12
  332.           
  333.  
  334.  
  335. 7. Future Plans
  336.  
  337. - More formats
  338.     .AIFC compressed
  339.     .WAVE 4Bit
  340.     .ADPCM
  341.     .Yamaha
  342.  
  343. - Additional platforms
  344.     .Macintosh
  345.     .DEC Alpha (OSF/1-Digital Unix)
  346.